home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 626-637 / disk_626 / qcd / qcd.doc < prev    next >
Text File  |  1992-05-06  |  11KB  |  233 lines
  1.  
  2. PROGRAM  
  3.                 QCD
  4.                                 
  5. SOURCE          Written in 100% assembler using Macro68 V3.165.
  6.  
  7.  
  8. AUTHOR          Nic Wilson
  9.                 Nic Wilson Software 
  10.                 (Registered CBM (Aust) developer)
  11.                 138d South Street
  12.                 TOOWOOMBA QUEENSLAND 4350
  13.                 Australia
  14.                                 
  15.                 EMAIL cbmvax!cbmaus!wilson!nic@uunet.uu.net
  16.                  
  17.                   or  cbmehq!cbmaus!wilson!nic@cbmvax.commodore.com
  18.                   
  19.                 TELEPHONE +61 76 358539 After Hours Australian Time
  20.                           +61 76 358384 Work  Hours Australian Time
  21.                 FAX       +61 76 358384 (Same as Work Telephone) 
  22.  
  23. FUNCTION 
  24.                 To quickly change directories in the current CLI/SHELL
  25.                 with the mouse and a file requester.  Ten often
  26.                 used directories can be saved to a config file and
  27.                 quickly selected.  Any unused entries are used
  28.                 to store the directories you have recently visited,
  29.                 and any of these can be easily and quickly selected 
  30.                 with the mouse or a function key.
  31.                 
  32. ACKNOWLEDGEMENTS
  33.  
  34.                 To my best friend John Rowe for the idea for QCD. 
  35.                 
  36.                 Thank you to my friend Paul Coward (Digisoft) for 
  37.                 a ...FAST assembler, Macro68 V3.  QCD assembles
  38.                 in 0.2 seconds on my A3000/68040!
  39.         
  40.                 Thank you to Fred Fish for his continuing work in 
  41.                 distribution of our programs.  Without his effort, 
  42.                 distribution would be much more difficult if not
  43.                 impossible.
  44.  
  45.                             
  46. COPYRIGHT       This program, its source code and document files are 
  47.                 (C) Copyright Nic Wilson Software 1992.  
  48.                 
  49. DISTRIBUTION    Fred Fish is exempt from the distribution conditions
  50.         stated below.
  51.                 
  52.         The program is Shareware and may be freely distributed
  53.                 on the condition that no profit is gained from this
  54.                 distribution either directly or indirectly.  A small
  55.                 copying fee, no more than the cost of 1 (one) average
  56.                 3.5 inch blank disk or $2.50 Australian whichever is the
  57.                 lesser.  
  58.                 
  59.                 If this program is placed on a disk containing various 
  60.                 utilities, the total charge for the disk MUST NOT BE
  61.                 GREATER THAN 2 (two) average 3.5 inch blank disks or
  62.                 $5.00 Australian whichever is the lesser.
  63.                 
  64.                 Crunching of the executable file is considered a breach
  65.                 of this agreement, due to the fact all current crunchers
  66.                 I have tested either fail, or are unstable on the 68040 
  67.                 CPU.  Archival in the form of 'lharc' type programs is 
  68.                 permitted.  
  69.                                 
  70. DONATIONS       All donations in the form of cash, money order,
  71.                 travellers cheques, bank draft (in AUS dollars),
  72.                 goods, software or hardware will be gratefully accepted,
  73.                 and ensure further shareware programs from me.
  74.                 Overseas users, please do not send personal cheques.  
  75.                 It is very difficult to convert them into cash.
  76.                 
  77.                 I give my sincere thanks to all those users who
  78.                 have donated to my work in the past.  It is with
  79.                 your continuing support to all programmers that the 
  80.                 Amiga has such a vast amount of quality shareware 
  81.                 programs available, and that I am able to continue 
  82.                 work on shareware programs aswell as commercial ones.  
  83.                 
  84.                 If you are using my programs and haven't donated then
  85.                 SHAME ON YOU.
  86.                  
  87.                 All users who donate will receive a disk, full of
  88.                 the latest versions of all my shareware programs.
  89.  
  90. REQUIREMENTS    Any Amiga
  91.         Any CPU 
  92.         AmigaDOS V2.0x
  93.                 'IPrefs' directories must be available.
  94.                 (ENV:sys) and (SYS:Prefs/env-archive/sys)
  95.                 
  96. INSTALLING    
  97.         QCD should reside in your C: directory or be in your
  98.         path somewhere.  When replacing versions V1.01 or V1.02
  99.         delete your config file in ENV:sys and create and save
  100.         a new one.  The config file for these two versions were
  101.         slightly different and could cause problems.                
  102.  
  103.  
  104. USAGE           QCD
  105.  
  106. NOTE            BECAUSE QCD IS A CLI/SHELL UTILITY DESIGNED TO CHANGE THE
  107. ----            DIRECTORY OF THE SHELL IT WAS LAUNCHED FROM, IT MUST
  108.                 NOT BE LAUNCHED WITH THE RUN COMMAND ETC.  IT WILL NOT WORK
  109.                 FROM A HOT KEY OR WORKBENCH ETC.  THE ONLY WAY THIS PROGRAM 
  110.                 WILL WORK IS IF YOU LAUNCH IT FROM THE CLI/SHELL BY HAND.
  111.                 
  112.                 IT HAS ONLY BEEN TESTED ON THE STANDARD SHELL FROM AmigaDOS.
  113.                 OTHER SHELLS MAY WORK BUT ARE UNTESTED.
  114.  
  115. RANDOM ACCESS DIRECTORIES                
  116. -------------------------
  117.  
  118.                 When the program is launched two windows will open.  
  119.                 An 'ASL' file requester window and another window containing 
  120.                 10 'action' gadgets, 10 string gadgets and three 'choice' 
  121.                 gadgets. 
  122.                 
  123.                 The 'ASL' file requester will default to the current 
  124.                 directory unless it finds a default directory in the config
  125.                 file.  The file reqester will display any directories within 
  126.                 this directory.  You can select a directory you require as 
  127.                 you normally would with a file requester and click OK. 
  128.                 
  129.                 If you desire a directory on another volume, select the 
  130.                 'Drives' gadget and all volumes and assigned directories 
  131.                 will be displayed.
  132.                 
  133.                 Once the OK gadget is clicked both windows will close and
  134.                 the directory and the prompt in the current CLI/SHELL will 
  135.                 change to this new directory selection.                                 
  136.                 
  137.                 If 'CANCEL' is selected the current CLI/SHELL will remain
  138.                 unchanged.
  139.                 
  140.                 For more information on the ASL file requester, see your
  141.                 AmigaDOS manual.
  142.                 
  143. PRESET DIRECTORIES
  144. ------------------
  145.                 
  146.                 Beside the file requester window is another window that 
  147.                 stores saved or recently visited directories.  There are
  148.                 ten gadgets labeled F1 to F0 down the left hand side of
  149.                 the window.  These ten are the 'action' gadgets for the
  150.                 string gadgets that are beside them.  If one of these
  151.                 gadgets is clicked or the corresponding function key 
  152.                 pressed one of two actions will result.  
  153.                 
  154.                 1. If the string gadget beside it is empty, the current 
  155.                    contents of the file requesters 'Drawer' gadget will be 
  156.                    placed in the string gadget.  This will saved to the
  157.                    temporary file automatically when you exit the program.
  158.                    It can be made permanent by clicking on the 'Save'. 
  159.                    gadget.   
  160.                 
  161.                 2. If the string gadget already contains a directory
  162.                    string, both windows will close and this directory
  163.                    will used to change the the current directory of
  164.                    the CLI.
  165.                    
  166.                 The ten string gadgets may be edited by hand if you
  167.                 wish, by clicking in the gadget and editing it.
  168.                 
  169.                 If you choose to set a directory by clicking on one of
  170.                 'action' gadgets, the current directory in the file 
  171.                 requesters 'Drawer' will also be saved to the temporary
  172.                 config file, and will be used to set the default directory
  173.                 in the file requester the next time QCD is launched.
  174.                 
  175. DIRECTORY HISTORY
  176. -----------------
  177.                 Any string gadgets that are not being used to store
  178.                 permanent directories, will be used by the program to 
  179.                 store a history of directories you have recently visited 
  180.                 via the file reqester.  When the 'OK' gadget is clicked in 
  181.                 the file requester this directory will be stored in the next
  182.                 available unused string gadget.  When all the gadgets are 
  183.                 filled, the oldest one will be replaced.  If all gadgets are
  184.                 used to store permanent dirctories, no history will be 
  185.                 available.  The contents of all gadgets can, of course, be
  186.                 made permanent at any time by clicking on the 'Save' gadget.           
  187.  
  188. CHOICE GADGETS
  189. --------------                
  190.  
  191. SAVE            This gadget will save the temporary file to the disk
  192.                 in the same directory that the normal system preferences
  193.                 are stored, and therefore the temporary ram: version will
  194.                 be automatically placed there by 'IPrefs' when booting.
  195.                                  
  196.                 As an obvious indication of which directory string gadgets
  197.                 are the saved permanent ones, their action gadgets beside
  198.                 them will be coloured in colour 3 and the rest in colour 2
  199.  
  200. LAST            This gadget will make the disk based config file the
  201.                 current file, and all gadgets will be updated.
  202.  
  203. CLEAR ALL       If you wish to clear all the string gadgets, click on
  204.                 'Clear All'.  This may be made permanent by choosing
  205.                 'Save'.  This will always be made temporary when you exit 
  206.                 the program.
  207.                 
  208. THE CONFIG FILE
  209. ---------------
  210.                 The config file works in a similar way to the system
  211.                 preferences files.  The permanent file is called 
  212.                 'qcd.config' and resides in 'SYS:prefs/env-archive/sys'.
  213.                 The memory based temporary file has the same name and 
  214.                 resides in the 'ENV:sys' directory.                
  215.                 
  216. TRADEMARKS AND COPYRIGHTS
  217.                
  218.         Amiga and AmigaDOS are trademarks of Commodore Amiga Inc.
  219.         Macro68 is a trademark of DigiSoft.
  220.         QCD is a trademark of Nic Wilson Software. 
  221.                 ASL library name and definitions are (C) Copyright 1989,1990 
  222.                 Commodore-Amiga Inc. and Charlie Heath.  All Rights Reserved
  223.         
  224. REFERENCE MATERIAL USED IN THE PRODUCTION OF QCD
  225.                 
  226.         M68000PM/AD  Programmers Reference Manual (inc. CPU32)
  227.         Published by Motorola Literature Distribution USA.
  228.                 
  229.     V2.04 Autodocs & Includes developer disk based versions.
  230.                 
  231.                 
  232.                 
  233.